home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 January / macformat-020.iso / Shareware City / Developers / Commander Sets / 4D Speech Pack / 4D Speech Pack.rsrc / TEXT_19969_†SP Can Speak.txt < prev    next >
Encoding:
Text File  |  1994-09-14  |  1.9 KB  |  44 lines

  1. SP Can speak -> present
  2.  
  3. present       integer       indicates if the speech functions of Speech Pack
  4.                                     can succesfully be called.
  5.                   At the moment these values can be returned:
  6.                   -1    Speeck Pack is disabled by the SPEECH OFF command.
  7.                    0     Speech Pack not usable, external package functions
  8.                           can't be called.
  9.                    1    Speech Pack usable, external package functions can be
  10.                          called.
  11.                    (2 and higher may be used later when other abilities are
  12.                    added to the Speech Manager and these are implemented in
  13.                    this external, so every value greater than zero implies
  14.                    Speech Pack is available.)
  15.  
  16. Returns an integer indicating if you can use the Speech Pack functions to produce speech.
  17.  
  18. If SP Can Speak returns a value greater than zero,  all other functions can be used (except SP Count voices, SP VERSION and SP COPYRIGHT whom can always be called).
  19. However, when the value returned is zero or negative and you call any of the other functions an error will be returned (-4).
  20.  
  21. When this function returns zero this means there are one or more conditions not met:
  22. 1) the Speech Manager is not installed (use SP VERSION to see if this
  23.     is the case)
  24. 2) Speech Pack was unable to set up its private data when the data-base
  25.     was launched, perhaps because not enough memory was available
  26.     (only 984 bytes needed!).
  27. 3) when using a time-limited beta-version of Speech Pack the expiration
  28.     date may have been passed and the external package refuses to
  29.     function.
  30. 4) when using Speech Pack together with 4D Server the maximum
  31.     number of users may be reached.
  32.  
  33. Example:
  34.   $present := SP Can speak
  35.  
  36.   If ($present > 0)
  37.     ALERT ("Speech Pack available.")
  38.   Else
  39.     ALERT ("Speech Pack not available.")
  40.   End if
  41.  
  42.  
  43.  
  44.